home *** CD-ROM | disk | FTP | other *** search
/ World Wide Web Encyclopedia / World Wide Web Encyclopedia CD.iso / pc / wwwe / logs / archie.log < prev    next >
Encoding:
Text File  |  1995-09-18  |  8.2 KB  |  199 lines
  1. >man archie
  2.  
  3. ARCHIE(1)                                               ARCHIE(1)
  4.  
  5. NAME
  6.        archie  -  query  the Archie anonymous FTP databases using
  7.        Prospero
  8.  
  9. SYNOPSIS
  10.        archie [ -cers ] [ -a ] [ -l ] [ -t ] [ -m hits ]
  11.               [ -N [ level ] ] [ -h hostname ] [ -o filename ]
  12.               [ -L ] [ -V ] [ -v ] string
  13.  
  14. DESCRIPTION
  15.        archie queries an archie anonymous  FTP  database  looking
  16.        for  the  specified  string  using  the Prospero protocol.
  17.        This client is based on Prospero version Beta.4.2  and  is
  18.        provided  to  encourage  non-interactive use of the Archie
  19.        servers  (and  subsequently  better  performance  on  both
  20.        sides).   This  man  page  describes  version  1.3  of the
  21.        client.
  22.  
  23.        The general method of use is of the form
  24.  
  25.               % archie string
  26.  
  27.        This will go to the archie server and ask it to  look  for
  28.        all known systems that have a file named `string' in their
  29.        FTP area.  archie will wait, and print out any matches.
  30.  
  31.        For example,
  32.  
  33.               % archie emacs
  34.  
  35.        will find all anonymous FTP sites in the  archie  database
  36.        that  have  files named emacs somewhere in their FTP area.
  37.        (This particular query would  probably  return  a  lot  of
  38.        directories.)   If  you want a list of every filename that
  39.        contains emacs anywhere in it, you'd use
  40.  
  41.               % archie -c emacs
  42.  
  43.        Regular expressions, such as
  44.  
  45.               % archie -r '[xX][lL]isp'
  46.  
  47.        may also be used for searches.  (See the manual of a  rea-
  48.        sonably good editor, like GNU Emacs or vi, for more infor-
  49.        mation on using regular expressions.)
  50.  
  51. OPTIONS
  52.        The options currently available to this archie client are:
  53.  
  54. Archie (Prospero)        26 October 1992                        1
  55.  
  56. ARCHIE(1)                                               ARCHIE(1)
  57.  
  58.        -c          Search  substrings paying attention to upper &
  59.                    lower case.
  60.        -e          Exact string match.  (This is the default.)
  61.        -r          Search using a regular expression.
  62.        -s          Search substrings ignoring  the  case  of  the
  63.                    letters.
  64.        -ofilename  If  specified, place the results of the search
  65.                    in filename.
  66.        -a          Output results as Alex filenames.
  67.        -l          Output results in a form suitable for  parsing
  68.                    by programs.
  69.        -t          Sort the results inverted by date.
  70.        -mhits      Specifies the maximum number of hits (matches)
  71.                    to return (default of 95).
  72.        -Nlevel     Sets the niceness of a query; by default, it's
  73.                    set   to   0.   Without  an  argument,  ``-N''
  74.                    defaults to 35765.  If  you  use  -N  with  an
  75.                    argument  between  0  and  35765, it'll adjust
  76.                    itself accordingly.   (Note:  VMS  users  will
  77.                    have  to  put quotes around this argument, and
  78.                    -L, like "-N45"; VMS will otherwise convert it
  79.                    to lowercase.)
  80.        -h hostname Tells  the  client  to query the Archie server
  81.                    hostname.
  82.        -L          Lists the Archie servers known to the  program
  83.                    when  it  was compiled, as well as the name of
  84.                    the default Archie server.  For an  up-to-date
  85.                    list, write to ``archie@archie.mcgill.ca'' (or
  86.                    any Archie server) with the single command  of
  87.                    servers.
  88.        -V          With the verbose option, archie will make some
  89.                    comments along the way if a search is going to
  90.                    take some time, to pacify the user.
  91.  
  92.        The  three search-modifying arguments (``-c'', ``-r'', and
  93.        ``-s'') are all mutually  exclusive;  only  the  last  one
  94.        counts.   If you specify -e with any of ``-c'', ``-r'', or
  95.        ``-s'', the server will first check for  an  exact  match,
  96.        then fall back to the case-sensitive, case-insensitive, or
  97.        regular expression  search.   This  is  so  if  there  are
  98.        matches that are particularly obvious, it will take a min-
  99.        imal amount of time to satisfy your request.
  100.  
  101.        If you list a single `-' by itself, any further  arguments
  102.        will  be  taken  as  part  of  the search string.  This is
  103.        intended to enable searching for strings that begin with a
  104.        `-'; for example:
  105.  
  106.               % archie -s - -old
  107.  
  108.        will  search  for  all  filenames  that contain the string
  109.        `-old' in them.
  110.  
  111. Archie (Prospero)        26 October 1992                        2
  112.  
  113. ARCHIE(1)                                               ARCHIE(1)
  114.  
  115. RESPONSE
  116.        Archie servers are set  up  to  respond  to  a  number  of
  117.        requests  in  a queued fashion.  That is, smaller requests
  118.        get served much more quickly than do large requests.  As a
  119.        result, the more often you query the Archie server, or the
  120.        larger your requests, the longer the  queue  will  become,
  121.        resulting  in  a  longer  waiting  period  for  everyone's
  122.        requests.  Please be frugal when possible, for your  bene-
  123.        fit as well as for the other users.
  124.  
  125. QUERY PRIORITY
  126.        Please  use  the  ``-N''  option whenever you don't demand
  127.        immediacy, or when you're  requesting  things  that  could
  128.        generate  large  responses.   Even  when  using  the  nice
  129.        option, you should still try to avoid big jobs during busy
  130.        periods.   Here  is  a list of what we consider to be nice
  131.        values that accurately reflect the priority of  a  job  to
  132.        the server.
  133.  
  134.               Normal              0
  135.               Nice                500
  136.               Nicer               1000
  137.               Very Nice           5000
  138.               Extremely Nice      10000
  139.               Nicest              32765
  140.  
  141.        The last priority, Nicest, would be used when a job should
  142.        wait until the queue is essentially empty before  running.
  143.        You should pick one of these values to use, possibly modi-
  144.        fying it slightly depending on where you think your prior-
  145.        ity should land.  For example, 32760 would mean wait until
  146.        the queue is empty, but jump ahead of other jobs that have
  147.        selected Nicest.
  148.  
  149.        There  are  certain  types of things that we suggest using
  150.        Nicest for, irregardless.  In particular, any searches for
  151.        which  you  would  have  a hard time justifying the use of
  152.        anything but extra resources.  (We  all  know  what  those
  153.        searches would be for.)
  154.  
  155. ENVIRONMENT
  156.        ARCHIE_HOST
  157.                This will change the host archie will consult when
  158.                making queries.  (The default value is what's been
  159.                compiled  in.)   The  ``-h''  option will override
  160.                this.  If you're  running  VMS,  create  a  symbol
  161.                called ARCHIE_HOST.
  162.  
  163. SEE ALSO
  164.        For  more information on regular expressions, see the man-
  165.        ual pages on:
  166.  
  167.        regex(3), ed(1)
  168.  
  169. Archie (Prospero)        26 October 1992                        3
  170.  
  171. ARCHIE(1)                                               ARCHIE(1)
  172.  
  173.        Also   read   the   file    archie/doc/whatis.archie    on
  174.        archie.mcgill.ca  for  a  detailed  paper  on  Archie as a
  175.        whole.
  176.  
  177.        Read the file README.ALEX distributed with this client for
  178.        more  information  on  what  Alex  is and how you can take
  179.        advantage of it.
  180. AUTHORS
  181.        The archie service was conceived and implemented  by  Alan
  182.        Emtage       (bajan@cs.mcgill.ca),      Peter      Deutsch
  183.        (peterd@cs.mcgill.ca),    and    Bill    Heelan     (whee-
  184.        lan@cs.mcgill.ca).   The entire Internet is in their debt.
  185.  
  186.        The  Prospero  system  was  created  by  Clifford   Neuman
  187.        (bcn@isi.edu);  write  to  info-prospero@isi.edu  for more
  188.        information on the protocol and its use.
  189.  
  190.        This stripped client was put  together  by  Brendan  Kehoe
  191.        (brendan@cygnus.com),  with modifications by Clifford Neu-
  192.        man and George Ferguson (ferguson@cs.rochester.edu).
  193.  
  194. BUGS
  195.        There are none; only a few unexpected features.
  196.  
  197. Archie (Prospero)        26 October 1992                        4
  198.  
  199.